home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / modelers / blob10a / read.me < prev   
Text File  |  1994-03-13  |  11KB  |  310 lines
  1. BLOB SCULPTOR ( BS ) version 1.0a
  2. by Alfonso Hermida, Steve Anger, Truman Brown    3/13/94
  3.  
  4. This program helps you manipulate and model 3D objects thru the use of
  5. blobs.
  6.  
  7. THIS PROGRAM IS FREEWARE ... BUT, USE AT YOUR OWN RISK.
  8.  
  9. ------------------------------------------------
  10. Requirements:  386 or better with coprocessor  :
  11.            VGA graphics card               :
  12.            mouse                           :
  13. ------------------------------------------------
  14.  
  15. You can reach us at:
  16.  
  17. * TGA BBS (510)524-2780
  18. * Pi Square BBS (301)725-9080     (Alfonso's the Sysop)
  19. * CompuServe: GraphDev forum
  20.  
  21. Thanks to:
  22.  
  23.        * Dan Farmer for the interest and enormous amount of feedback and
  24.      Beta testing.
  25.        
  26.        * Ronald Praver for speeding up suggestions.  Ron is the author
  27.      of World Render 3D, a wireframe modeler and translator.  He's 
  28.      currently developing the Windows version of Blob Sculptor.
  29.  
  30.        * David K. Mason for the program's name.
  31.  
  32.        * Bill Allen, editor of 3D Artist.  3D Artist is dedicated to 
  33.      computer graphics and publishes how-to articles on computer
  34.      graphics programs for different platforms.  For more info:
  35.  
  36.                  3D Artist
  37.         PO Box 4787, Santa Fe NM 87502-4787
  38.         Voice (505)982-3532   FAX   (505)820-6929
  39.  
  40.  
  41. Silicon Graphic's Open GL Developers
  42. ------------------------------------
  43.  
  44. If you know how to program on Open GL for the Silicon Graphics, please
  45. contact Alfonso Hermida.  He has part of the code already ported to GL.
  46. The next step is to create the user interface.
  47.  
  48.  
  49. -------------------------------------------------------------------------
  50. DEFINITION :   LMB  = Left Mouse Button
  51.            RMB  = Right Mouse Button
  52. -------------------------------------------------------------------------
  53.  
  54. INTERFACE:
  55. ----------
  56. BS's display consists of 3 principal views:
  57.  
  58.                        Vertical Axis    Horizontal Axis
  59.    Top    (upper left window)               Z                 X
  60.    Front  (lower left window)               Y                 X
  61.    Side   (lower right window)              Y                 Z
  62.  
  63. and a preview window (upper right window referred to as ISO) which can be
  64. modified thru the CAMERA command.  Finally the right side is the MENU 
  65. area.
  66.  
  67. The horizontal and vertical coordinates of the mouse are displayed in the
  68. MENU area.  The name of the view window where the mouse is currently 
  69. located is displayed above the coordinates.
  70.  
  71.  
  72. SUMMARY OF COMMANDS:
  73. --------------------
  74. After each command description the letters F, S, T and Iso are used to 
  75. define in which views the command is valid.  If no letters are present, 
  76. the command doesn't apply in that view.
  77.  
  78. BS preserves the last command selected.  To execute the previous command,
  79. click the LMB. (Some of the commands can't be repeated - this is done 
  80. either for convenience or for safety).
  81.  
  82. Most commands may also be activated by pressing the key corresponding to
  83. the highlighted letter of the command as well.
  84.  
  85.  
  86. FILE
  87. ----
  88. This command presents series of file-related subcommands.
  89.    NEW:   Deletes the whole database - fresh start!
  90.    SAVE:  Writes data to a file.  Files may be saved in the following
  91.       formats:
  92.  
  93.       * BLOB     Blob Sculptor
  94.       * POV      Persistence of Vision raytracer
  95.       * POLYRAY  Polyray raytracer
  96.       * RAYSHADE Rayshade raytracer
  97.       * RAW      polygons
  98.       * CTDS     Connect The Dots System
  99.       * DXF      Autodesk's Data eXchange Format
  100.  
  101.    LOAD:  Reads in a Blob Sculptor file.  Existing data is overwritten.
  102.    MERGE: Reads in a Blob Sculptor file.  New data is merged with
  103.       existing data.
  104.  
  105.    The Blob Sculptor format is an ASCII file described as follows:        
  106.       
  107.       threshold
  108.       x y z strength radius
  109.       x y z strength radius 
  110.       x y z strength radius                                                                 
  111.       x y z strength radius                                                                 
  112.       ....etc....
  113.  
  114.       * Lines prefixed with a semicolon are ignored as comments *                                                                
  115.  
  116.    Example: (file HAND.BLB)
  117.  
  118.       0.6
  119.      -0.413502  0.0253165  0 1 1.50823
  120.       0.43038  -0.00843882 0 1 1.59972
  121.      -0.548523 -1.18987    0 1 1.45752
  122.       0.700422 -1.20675    0 1 1.4348
  123.       1.49367  -0.548523   0 1 0.983246
  124.       1.72996   0.109705   0 1 0.747382
  125.       1.79747   0.683544   0 1 0.683805
  126.       1.82278   1.21519    0 1 0.676372
  127.       0.759494  0.911392   0 1 0.714533
  128.       0.742616  1.50211    0 1 0.676372
  129.       0.691983  2.16034    0 1 0.749914
  130.       0.599156  2.79325    0 1 0.708316
  131.       0.43038   3.50211    0 1 0.718941
  132.      -0.21097   1.08861    0 1 0.679169
  133.      -0.312236  1.74684    0 1 0.714533
  134.      -0.464135  2.42194    0 1 0.629936
  135.      -0.666667  3.09705    0 1 0.698434
  136.      -0.919831  3.80591    0 1 0.715417
  137.      -1.0211    1.0211     0 1 0.640875
  138.      -1.30802   1.64557    0 1 0.621859
  139.      -1.57806   2.23629    0 1 0.670744
  140.      -1.86498   2.84388    0 1 0.620842
  141.      -1.4346   -0.151899   0 1 1.21077
  142.      -1.33333  -1.26582    0 1 1.24168
  143.      -2.04219   0.691983   0 1 0.670743
  144.      -2.4135    1.29958    0 1 0.674501
  145.       1.80591   1.90717    0 1 0.78531
  146.      -2.75105   1.77215    0 1 0.555298
  147.  
  148.      ;This file creates a 3D hand.
  149.  
  150. CREATE (F, T, S)
  151. ----------------
  152. This command creates a blob component in any of the 3 principal views. 
  153. After selecting this command, click the LMB to define the center of the
  154. component.  Next, move the mouse to define the radius.  Finally, press 
  155. the LMB to accept or the RMB to CANCEL.
  156.  
  157. To manually create blob components at specific coordinates, you may press
  158. the key combination ALT-C to bring up an input panel for the coordinate
  159. values.  After entering coordinate values, press ENTER (or click on OK) to
  160. accept, or press ESC (or click the RMB) to cancel.
  161.  
  162. MOVE  (F, T, S)
  163. ---------------
  164. You may move a component to another location at anytime by selecting the
  165. MOVE command.  To select the component to be moved, click on any part of 
  166. the circle to be moved.  The circle will be highlighted (yellow color).  
  167. Now, move the mouse to the view where you want to perform the move 
  168. operation and press the LMB.  A ghost image will appear in case you want 
  169. to locate it in it's original place.  Press the LBM to accept the new 
  170. location or RMB to CANCEL.
  171.  
  172. This command is different from most others because sometimes it's easier
  173. to select a component in a view different from the one where the move will be
  174. performed.
  175.  
  176.  
  177. COPY (F, T, S)
  178. --------------
  179. The COPY command behaves the same as the MOVE command but doesn't delete
  180. the original component.
  181.  
  182.  
  183. RESIZE (F, T, S)
  184. ----------------
  185. You may resize a component at anytime by selecting the RESIZE command.  To
  186. select the component to be resized, click on any part of the circle.  The
  187. circle will be highlighted and a beep will indicate that you may resize
  188. the component.  A ghost image will appear in case you want resize it to
  189. it's original size.  Press LBM to accept the new location or RMB to CANCEL.
  190.  
  191.  
  192. REDRAW 
  193. ------
  194. This command refreshes ALL the views. Negative components are drawn in red.
  195.  
  196.  
  197. ZOOM (F, T, S, Iso)
  198. -------------------
  199. To zoom In or Out, click on any of the views.  The mouse button will
  200. determine the zooming operation:
  201.    LMB     Zoom In
  202.    RMB     Zoom Out
  203.  
  204. To control the rate of zoom, click on the ZFACTOR button.  This will bring
  205. up a panel where you may input a value for the zoom factor.  Higher values
  206. produce faster zooms.  The maximum zoom factor is 10.
  207.  
  208.  
  209. DELETE (F, T, S)
  210. ----------------
  211. To delete a component, click the LMB on any part of the circle.  You'll be
  212. asked if you want to continue.  To delete the object click on [OK].
  213.  
  214.  
  215. MIRROR, MIRROR AXIS (F, T, S)
  216. -----------------------------
  217. The Mirror command mirrors the selected component, depending on the status of
  218. the Mirror Axis button.  Components are mirrorred about the origin.  If 
  219. a selected component already has a mirror copy, you will be presented with
  220. a message stating such.  Simply click on [OK] and try another component.
  221.  
  222. PAN (F, T, S)
  223. -------------
  224. You may perform panning by clicking on the PAN command.  By clicking
  225. on any of the 3 principal views, the point will become the center of that
  226. scene.  If the view gets out of limits and you can't return it back, reset
  227. it using the ORIGIN command.
  228.  
  229. ORIGIN (F, T, S)
  230. ----------------
  231. This command puts the origin back in the center of the selected view. Click
  232. on the ORIGIN icon then click on one of the principal views....the 3D axis
  233. will appear in the center.
  234.  
  235.  
  236. CAMERA ( Iso )
  237. --------------
  238. Changes the From, At and Up vectors for the Iso view.
  239.  
  240. PREVIEW (Iso )
  241. --------------
  242. NOTE: Be sure that you have saved your data before previewing it!  This is
  243.       an experimental program.
  244.  
  245. Generates a wireframe representation of the current scene.  BS tries to
  246. display a hidden line representation, but some triangles may not show up.
  247. This doesn't affect the scene if it is saved as RAW data.  When saved as
  248. RAW data all the triangles will be written.
  249.  
  250. DENSITY (F, T, S)
  251. -----------------
  252. Select a component to change it's strength(density) value.  The value can
  253. be positive or negative.  To accept the default value press [Enter].
  254. NOTE: Math errors may occur if the density selected is less than or equal
  255.       to the threshold value.  BS has been programmed to reset itself if
  256.       a fatal math error occurs.  In most cases, the reset procedure
  257.       should preserve your data.  If a reset occurs, save your data
  258.       immediately, exit and restart the program.
  259.  
  260. DETAIL
  261. ------
  262. This value, between 20 and 50 determines the resolution in the algorithm 
  263. used to evaluate the blob surfaces.  The values affect the program in 
  264. this way:
  265.     20     fastest,  least resolution, uses less memory
  266.     :
  267.     :
  268.     50     slowest,  best resolution,  uses more memory
  269.  
  270. For PREVIEWing, it's good to have a small number, between 20 and 30.  For the
  271. final image generation, 30 and up is good (unless you like the resolution
  272. given by lower numbers).
  273.  
  274. Needless to say, the higher the number, the greater the number of triangles
  275. that will be generated when creating RAW data output.
  276.  
  277.  
  278. THRESHOLD
  279. ---------
  280. Changes the Threshold value for the blobs.
  281. See NOTE pertaining to Density above.
  282.  
  283. SNAP
  284. ----
  285. Turns On/Off the SNAP feature.
  286.  
  287. GRID  &  ROW/COL
  288. ----------------
  289. The GRID command enables the grid.  The grid is redrawn with every redraw.
  290. The ROW/COL command sets the number of divisions (# of rows = # columns) 
  291. in the grid.
  292.  
  293. QUIT
  294. ----
  295. Exit the program.
  296.  
  297. ABOUT
  298. -----
  299. Tells you who the authors are!
  300.  
  301. ------------------------------------------------------------------------
  302.  
  303. ADDITIONAL INFO:
  304.  
  305. * THRESHOLD          default value 0.6
  306. * STRENGTH (DENSITY) default value 1.0
  307. * Maximum number of components is 500            (INCREASED)
  308. * ROW/COL value      default value 20
  309. -------------------------------------------------------------------------
  310.